home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac: Not for Sale / Another.not.for.sale (Australia).iso / hold me in your arms / PGP 2.6 / pgp2.6 Source / doc / HowTo.doc < prev    next >
Text File  |  1994-05-20  |  3KB  |  80 lines
  1.                             PGP How-To
  2.                                 or
  3.                How to build PGP 2.6 in two easy steps
  4.  
  5.                            Derek Atkins
  6.                         <warlord@MIT.EDU>
  7.                             22-May-94
  8.  
  9.     This document describes how to build PGP 2.6 from the sources
  10. provided.  If you are reading this document, then I assume that you
  11. have already retrived the sources and unpacked them.
  12.  
  13.     The first thing you will notice is that there is more than one
  14. directory tree in the PGP 2.6 source distribution.  In particular,
  15. there is the rsaref2 tree, and then there is the pgp26 tree.  The
  16. rsaref2 directory contains the sources for RSAREF, the reference RSA
  17. implementation from RSADSI, Inc.  The pgp26 directory contains the PGP
  18. sources.
  19.  
  20.     Before you go any further, please read the PGP documentation.
  21. I cannot stress how important it is for you to read this.  It explains
  22. not only how to use the software, but also its limitations, drawbacks,
  23. and other issues of which you should be aware.  The documentation is a
  24. good source of information and you should use it.
  25.  
  26.     Now, on the build instructions:
  27.  
  28. VMS:
  29.  
  30.     If you are building this on a VMS system, then you should
  31. change directories into the vmssource subdirectory of pgp26.  In
  32. there, there is a program called "allbuild.com" which should build all
  33. of PGP for you.  Just execute that, and it should work.
  34.  
  35. UNIX:
  36.  
  37.     If you are building on a UNIX platform, you need to build the
  38. RSAREF code first, and then the PGP sources.  First, you should cd
  39. into rsaref2/install/unix and type "make".  It is possible that this
  40. will fail, giving you a lot of errors, such as syntax errors or
  41. parameters declared as non-functions.  If you get these errors, then
  42. that means that your compiler does not understand prototypes.  There
  43. are two things you can do to correct this.  The first is to use gcc,
  44. the GNU CC compiler:
  45.     make CC=gcc
  46.  
  47.     If this is not reasonable, then you can edit the Makefile and
  48. change the line that contains:
  49.     -DPROTOTYPES=1      and change it to read:
  50.     -DPROTOTYPES=0
  51.  
  52.     Once you've done this, you should have a file rsaref.a.  The
  53. next step is to compile the pgp sources.  For this, you should go back
  54. to the top of the tree and cd into pgp26/src.  From here, you should
  55. find the make rule for your platform (if you just type "make", it will
  56. list out the known platforms).  Once you find your platform, just use
  57. that makerule.  For example, if you are on linux, then you should:
  58.     make linux
  59.  
  60.     If you cannot find a make rule for your platform, you may have
  61. to create one yourself.  If you successfully create a rule for a new
  62. platform, please send the patches to pgp-bugs@mit.edu, so it can be
  63. added to the next release.
  64.  
  65. Note: PGP 2.6 requires the function memmove.  Not all machines have
  66. this in the standard C library.  There is an implementation of memmove
  67. included with this distribution.  If you find that your platform
  68. requires memmove, but the makefile rule for your platform does not
  69. include memmove (look at the sun4gcc or sun386i rules for an example
  70. of how to include it), please send mail to pgp-bugs@mit.edu, so we can
  71. correct the problem.
  72.  
  73.     If you have any problems, bugs, patches, etc., please send
  74. mail to pgp-bugs@mit.edu!
  75.  
  76.                     Thank you,
  77.  
  78.                     Derek Atkins
  79.                     <warlord@MIT.EDU>
  80.